QuickTime 4 Reference

HSL Balance Filter

kHSLColorBalanceImageFilterType ('hsvb')

This filter effect allows you to independently adjust the hue, saturation and lightness (also known as value or brightness) channels of a single source. The effect adjusts every pixel in the source, multiplying the hue component of the pixel by the value of the hue multiplier parameter, the saturation component by the value of the saturation multiplier parameter, and so on.

Example:

The HSL balance filter effect takes one source and has three parameters.

Parameters

Use the descriptions below to help you understand what the parameters do. To learn how to use parameter atoms, see "Adding Video Effects to a QuickTime Movie"

Name	Code	QTAtom Type	Description
Hue multiplier	`'hmul'`	`kParameterTypeDataFixed` Can be a tween	The amount by which to adjust the hue channel value of each pixel.
Saturation multiplier	`'smul'`	`kParameterTypeDataFixed` Can be a tween	The amount by which to adjust the saturation channel value of each pixel.
Lightness multiplier	`'vmul'`	`kParameterTypeDataFixed` Can be a tween	The amount by which to adjust the lightness channel value of each pixel.

Name

Code

QTAtom Type

Description

Hue
multiplier

'hmul'

kParameterTypeDataFixed

Can be a tween

The amount by which to adjust the hue channel value of each pixel.

Saturation
multiplier

'smul'

kParameterTypeDataFixed

Can be a tween

The amount by which to adjust the saturation channel value of each pixel.

Lightness multiplier

'vmul'

kParameterTypeDataFixed

Can be a tween

The amount by which to adjust the lightness channel value of each pixel.